---
displayed_sidebar: "Chinese"
---

# SHOW BACKENDS

## 功能

查看当前集群中所有 BE 节点的相关信息。

> **注意**
>
> 该操作需要 SYSTEM 级 OPERATE 权限或 `cluster_admin` 角色。

## 语法

```SQL
SHOW BACKENDS
```

## 返回信息说明

```SQL
+-----------+-----+---------------+--------+----------+----------+---------------+---------------+-------+----------------------+-----------------------+-----------+------------------+---------------+---------------+---------+----------------+--------+----------+--------+-------------------+-------------+----------+
| BackendId | IP  | HeartbeatPort | BePort | HttpPort | BrpcPort | LastStartTime | LastHeartbeat | Alive | SystemDecommissioned | ClusterDecommissioned | TabletNum | DataUsedCapacity | AvailCapacity | TotalCapacity | UsedPct | MaxDiskUsedPct | ErrMsg | Version  | Status | DataTotalCapacity | DataUsedPct | CpuCores |
+-----------+-----+---------------+--------+----------+----------+---------------+---------------+-------+----------------------+-----------------------+-----------+------------------+---------------+---------------+---------+----------------+--------+----------+--------+-------------------+-------------+----------+
```

返回信息中的参数说明如下：

| **参数**               | **说明**                                                     |
| --------------------- | ------------------------------------------------------------ |
| BackendId             | BE 的 ID。                                                   |
| IP                    | BE 的 IP 地址。                                              |
| HeartbeatPort         | BE 上的心跳端口，用于接收来自 FE 的心跳。                    |
| BePort                | BE 上的 Thrift server 端口， 用于接收来自 FE 的请求。        |
| HttpPort              | BE 上的 HTTP server 端口，用于网页访问 BE。                  |
| BrpcPort              | BE 上的 bRPC 端口，用于 BE 之间通讯。                        |
| LastStartTime         | BE 最后一次启动的时间。                                      |
| LastHeartbeat         | FE 最后一次发心跳给 BE，且 BE 成功回复的时间。               |
| Alive                 | BE 是否存活。<ul><li>`true`：表示存活。</li><li>`false`：表示没有存活。 </li></ul>      |
| SystemDecommissioned  | BE 是否已下线。下线前，该 BE 节点的数据会迁移到其他 BE 节点上，期间不影响数据导入和查询。<ul><li>`true`：表示集群已经标记该 BE 下线（数据可能已经完成迁移，或还在迁移中）。</li><li>`false`：表示集群正常使用该 BE（未执行下线操作）。</li></ul> |
| ClusterDecommissioned | 该参数用于系统兼容。                                         |
| TabletNum             | BE 上 tablet 的数量。                                        |
| DataUsedCapacity      | 数据文件占用的磁盘空间。                                     |
| AvailCapacity         | 可使用的磁盘空间。                                           |
| TotalCapacity         | 总磁盘空间，即为 `DataUsedCapacity` + `AvailCapacity` + 非数据文件占用的空间。 |
| UsedPct               | 磁盘使用量百分比。                                           |
| MaxDiskUsedPct        | 一个 BE 节点如果有多个存储数据的路径，该参数为存储数据最多的路径占用磁盘的百分比。 |
| ErrMsg                | 接收 FE 心跳失败时的错误信息。                               |
| Version               | 当前集群的版本。                                             |
| Status                | BE 最后一次向 FE 报告 tablet 数量的时间，以 JSON 格式显示 。 |
| DataTotalCapacity     | `DataUsedCapacity` + `AvailCapacity`，即数据文件所占用的磁盘空间 + 可使用的磁盘空间。 |
| DataUsedPct           | `DataUsedCapacity`/`DataTotalCapacity`，即数据文件所占用的磁盘空间/（数据文件所占用的磁盘空间 + 可使用的磁盘空间）。 |
| CpuCores              | BE 机器的 CPU 核数。                                         |

## 示例

查看当前集群中的所有 BE 节点的相关信息。

```Plain
SHOW BACKENDS;

+-----------+---------+---------------+--------+----------+----------+---------------------+---------------------+-------+----------------------+-----------------------+-----------+------------------+---------------+---------------+---------+----------------+--------+----------------------+--------------------------------------------------------+-------------------+-------------+----------+
| BackendId | IP      | HeartbeatPort | BePort | HttpPort | BrpcPort | LastStartTime       | LastHeartbeat       | Alive | SystemDecommissioned | ClusterDecommissioned | TabletNum | DataUsedCapacity | AvailCapacity | TotalCapacity | UsedPct | MaxDiskUsedPct | ErrMsg | Version              | Status                                                 | DataTotalCapacity | DataUsedPct | CpuCores |
+-----------+---------+---------------+--------+----------+----------+---------------------+---------------------+-------+----------------------+-----------------------+-----------+------------------+---------------+---------------+---------+----------------+--------+----------------------+--------------------------------------------------------+-------------------+-------------+----------+
| 10002     | x.x.x.x | 9254          | 9260   | 8238     | 8260     | 2022-09-08 14:37:10 | 2022-09-08 15:14:21 | true  | false                | false                 | 21753     | 25.122 GB        | 1.088 TB      | 1.968 TB      | 44.72 % | 44.72 %        |        | MAIN-RELEASE-d094052 | {"lastSuccessReportTabletsTime":"2022-09-08 15:14:13"} | 1.113 TB          | 2.20 %      | 16       |
| 10003     | x.x.x.x | 9254          | 9260   | 8238     | 8260     | 2022-09-08 14:37:20 | 2022-09-08 15:14:21 | true  | false                | false                 | 21754     | 25.121 GB        | 1.169 TB      | 1.968 TB      | 40.61 % | 40.61 %        |        | MAIN-RELEASE-d094052 | {"lastSuccessReportTabletsTime":"2022-09-08 15:14:22"} | 1.194 TB          | 2.06 %      | 16       |
| 10004     | x.x.x.x | 9254          | 9260   | 8238     | 8260     | 2022-09-08 14:37:39 | 2022-09-08 15:14:21 | true  | false                | false                 | 21754     | 25.112 GB        | 1.172 TB      | 1.968 TB      | 40.46 % | 40.46 %        |        | MAIN-RELEASE-d094052 | {"lastSuccessReportTabletsTime":"2022-09-08 15:13:42"} | 1.197 TB          | 2.05 %      | 16       |
+-----------+---------+---------------+--------+----------+----------+---------------------+---------------------+-------+----------------------+-----------------------+-----------+------------------+---------------+---------------+---------+----------------+--------+----------------------+--------------------------------------------------------+-------------------+-------------+----------+
```
